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SECTION  1 


PRIMER 


1.1  Purpose. 

GEOMED  is  (or  making  drawings,  synthetic  video  images,  and  3-0  geometric  models  (or  the  sake 
o(  computer  vision.  This  document  explains  the  external  commtr.d  language  o(  GEOMED  as  an 
interactive  drawing  program. 

1 .2  Running  GEOMED. 

The  system  copy  o(  GEOMED  is  started  by  typing  "R  GEOMED"  (carriage  return)  at  a  CRT 
vector  display  corn  ole,  rather  than  at  a  video  console.  The  program  will  display  a  rectangle,  type  an 
asterisk  and  await  single  character  commands  Typing  additional  carriage  returns  wili  yield  more 
asterisks  showing  that  GEOMED  is  alive  end  liste.  mg.  At  Stanford  the  CRT  vector  display  consoles 
were  made  by  Information  International  Inc  rid  are  called  "III"  (pronouced  "triple  eye"),  while  the 
video  display  consoles  were  nude  by  Data  Disc  and  are  cal'ed  T,i»  Discs";  inspite  of  local  jargon  I 
wish  to  refor  to  the  two  kinds  of  display  devices  by  generic  namest  CRT  or  vector  display  and  TV  or 
video  display 

1  3  Instant  Cube  and  Translation 

Typing  the  character  "oo",  calls  a  macro  that  makes  a  cube  Ad/ust  the  pots  on  the  display 
console  so  that  the  cube  looks  right.  The  cuba  may  be  movea  about  by  typing  the  character 
The  character  movas  the  cube  right  (positive  x  axis);  the  character  moves  the  cube  left 
(negative  x  axis);  the  character  ";"  moves  the  cube  up  (positive  y  a-  the  character  "("  moves  the 
cube  down  (negative  y  axis);  the  character  moves  the  cube  nearer  (positive  z  axis);  and  l.  e 
character  moves  the  cuke  awsy  (negative  7  axis).  Clearly  these  command  charccters  are  not 
mnemonics,  they  were  chosen  beesuse  they  do  not  require  the  T(V  key  and  are  conveniently  grouped 
in  pairs  under  one’s  right  hand  The  distance  the  cube  is  moved  on  each  command  is  called  the 
strength  of  translation  or  TDEL  Thu  value  of  TDEL  is  displayed  in  the  upper  right  cor  ner  of  the  screen 
and  is  initially  one  foot.  The  strength  of  translate  ’*  halved  by  typing  the  command  character  "/"  or 
doubled  by  typing  "\".  (Tho  unit  of  length  can  be  switched  to  maters  or  centimeters  by  the  "X 
METER"  and  "X  CM"  commands  respectively). 

14  World  Frame  of  Referance. 

The  direction  the  cube  moved  was  with  respec1  to  the  world  frame  of  reference  which  is  c  right 
handed  coordinate  system.  The  initial  camera  is  positioned  looking  down  the  1  axis  towards  the  world 
origin.  The  world  origin  is  in  the  center  of  the  displiy  screen  s  simulated  sixtaen  feet  away;  and  the 
positive  world  X  avis  is  to  your  right;  anrt  the  positive  world  Y  axis  is  upwsrds,  Coordinate  axes  can  be 
displayed  by  toggling  the  "/4L"  switch  command. 
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1 .5  Control,  Meta,  and  Meta-Control  Keys. 

Notice  that  the  Stanford  A.I  keyboard  has  four  "shift"  keys  Isoeled  SHIFT,  TOP,  META  & 
CONTROL  SHiFT  only  determines  whether  an  alphabetic  letter  jpper  or  lower  case;  GEOMED 
convsrls  lower  case  letters  Into  upper  so  that  the  SHIFT  key  has  no  effect  The  "*0P  key  allows  two 
ASCII  character  codes  to  be  on  each  physical  key;  this  doubling  up  on  the  physical  keys  is  not 
important  to  GEOMFD  since  ”TOP-EM  can  always  be  referred  to  as  "e".  Finally,  of  great  importance, 
the  CONTROL  and  META  keys  add  .wo  extra  bits  to  the  7-bit  ASCII  code,  so  that  a  9-bit  character  is 
formed  In  this  document  the  characters  V,  "fl"  and  'V'  will  be  used  as  prefix  abbreviations  for 
CONTROL,  META  and  META-CONTROL  keying  of  a  character  Furthermore,  the  command  scanner 
accepts  the  characters  V",  "fl"  and  'V  as  prefix  modifiers  that  will  add  the  appropriate  control  and 
msta  bits  to  the  next  character  typed  The  fourth  (and  final)  prefix  character  is  the  question  mark. 
Typing  a  followed  by  any  character  will  cause  a  one  line  reminder  to  oe  printed  of  what  commands 

are  invoked  by  that  character 

1 .6  Rotation. 

Tie  rotation  command  characters  are  the  same  as  for  translation  except  you  must  hold  the 
CONTROL  *ey  down  or  prefix  the  command  with  an  Y  Try  rotating  the  instant  cube  about  the  X-axis 
with  V:M.  The  positive  direction  of  rotation  is  counter-clockwise.  The  negative  direction  of  rotation  is 
clockwise  The  strength  of  rotation  is  named  RDEL  The  value  of  RDEL  is  displayed  in  two  formats  in 
the  upper  right  hand  corner  of  the  screen:  as  a  pi  fracloo  and  in  degrees,  minutes,  seconds.  The 
initial  value  of  RDEL  is  n/4,  45  degrees  Analogous  to  translation,  the  cVength  *  f  rotation  is  halved  or 
doubled  by  "o c/"  and  V\"  respective^  Since  a  sequence  o*  rotations  is  common,  there  is  a  way  to 
make  tho  CTRL  key  be  sticky  The  Euclidean  transformation  default  is  translation  world  frame;  but 
after  typin*  the  "o"  command  character,  the  Euclidean  default  is  rotation  world  frame.  Translation 
default  is  restored  by  typing  "!"  The  state  of  the  Euclidean  transformation  default  is  also  displayed  in 
the  status  in  the  upper  right  hand  corner  of  the  screen.  (The  command  disables  ihe  status  display; 
V  toggles). 

1.7  The  Stack 

GEOMED  commands  take  their  arguments  from  and  leave  their  results  in  a  push  down  stack  of 
bodies,  faces,  edges  and  vertices  The  contents  of  the  stack  are  displayed  on  the  *<aft  hand  side  of  the 
display  screen.  Every  kind  of  node  has  a  default  print  identifier,  for  the  first  body  created  a  fB X 1  i? 
displayed  in  the  stack.  Making  a  second  cube  will  push  a  'B2f  into  the  stack.  To  retrieve  'Bl'  use  the 
"T"  stack  pop  command  or  the  Vf"  stack  rotate  up  or  VI"  stack  rotate  down  or  V"  the  swap  top  of 
stack  command  The  "A"  command  pushs  the  stack  down  and  places  in  the  new  top  the  entity  that  wat 
previously  top  of  stack. 
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1  E  The  Extended  Command  Scanner. 

The  X -commands  are  executed  by  typing  "X"  followed  by  the  first  tl  ree  letters  of  a  mnemonic 
(further  letters  are  ignored)  followed  by  any  necessary  arguments.  The  command  is  terminated  by  a 
RETURN  The  arguments  may  be  separated  by  any  reasonable  delimiters:  space,  comma,  «*c.  The 
following  three  "X"  commands  provide  easy  creation  of  simple  polyhedra: 

X  CUBE  <DX  width>,<DY  heitht>,<DZ  depth) 

X  BALL  <radius>,<M  longitudes), <N  latitudes) 

X  CYLN  <radius>,<N  sides), <DZ  length) 

The  CUBE  command  makes  a  right  rectangular  prism  with  width,  height  vtd  depth  as  given.  The 
BALL  command  makes  a  polyhedron  that  approximates  a  sphere.  The  C\LN  command  makes  a  right 
prism  that  approximates  a  circular  cylinder 
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1 .9  The  Face,  Edge  and  Vertex  Structures 

A  polyhedron  consists  of  three  circular  double  linked  lists  (called  rings);  there  is  a  ring  of  faces, 

a  ring  of  edges  and  a  ring  of  vertices.  The  head  of  each  rin^  is  the  body  node.  The  rings  can  be 

traveled  by  using  the  commands  "<”  and  ">"  to  go  forwards  and  back  through  the  lace  ring,  the 
commands  T  and  "1"  <or  the  edge  ring,  and  the  commands  "v"  and  ma"  tor  the  vertex  ring.  Notice 
that  when  a  face,  edge  or  vertex  node  is  in  the  top  o<  the  stack  the  corresponding  entity  is  Intensi'ied 
in  the  drawing. 

In  addition  to  the  three  body  rings,  the  faces,  edges  and  v*;<ices  have  pointers  among 
themselves.  Faces  and  vertices  always  have  a  pointer  to  one  of  their  edges  called  the  "prime  edge" 
or  "PED"  The  PED  of  a  face  or  vertex  in  the  top  of  the  stack  may  be  retrieved  by  using  the  T’ 

command  On  the  other  hand,  edges  have  eight  pointers;  each  edges  points  at  its  two  faces,  it*  two 

vertices  and  its  four  neighboring  edges  (clockwise  and  counterclockwise)  in  each  of  its  two  faces. 
These  last  four  pointers  are  the  so  called  "wings"  for  which  the  representation  is  named  The  wings 
•re  oriented  so  that  a  traverse  of  a  face  (or  vertex)  perimeter  will  appear  oriented  counter  clockwise 
as  viewed  from  the  exterior  side  of  the  polyhedral  surface  Perimeter  traveling  is  exp'ained  in 
subsection  6  4;  it  suffices  now  only  to  be  aware  that  there  sxist  oriented  perimeters  that  can  be  easily 
traveled.  The  contents  of  the  non-wing  pointers  of  an  edge  can  be  brought  into  the  stack  by  the  'V" 
and  "a"  commands  for  the  two  vertices  of  the  edge,  and  by  the  "<"  and  ">"  commands  for  the  two 
faces  of  the  edge 

1.10  Hidden  Line  Elimination 

Typing  ALT-MODE  causes  your  drawing  to  be  displayed  with  its  hidden  lines  eliminated;  at  is 
illustrated  by  the  two  pictures  of  a  log  cabin  in  the  woods  To  stay  in  hidden  line  display  mode  use  the 
r  underDar  command;  the  "fiS  returns  the  display  mode  default  to  display  all  the  lines.  The  hidden 
line  eliminator,  named  OCCULT,  does  not  display  concave  faces  correctly;  and  for  the  sake  of  speed  it 
does  not  check  for  them  The  faces  of  a  polyhedra  can  be  forced  convex  by  applying  the  "I"  command 
to  a  body  or  to  a  fact. 
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1.1 1  Making  a  Cuba  Explicitly 

Attar  "eo"  and  "X  CUBE",  a  third  way  to  draw  a  cuba  will  ba  given  to  illustrata  tha  primitive 
topology  commands  Starling  with  a  trash  copy  ot  GEOMED,  typa  tha  command  latta<-c  In  tha  sacond 
column  to  gat  tha  advartisad  rasults: 

1  V  Vartax  body  craation. 

2  s)  Position  tha  vartax  into  tha  first  quadrant. 

3.  S;;  Maka  an  adga  and  vartax  and  mova  latt. 

4  S((  Edga  vartax  down 

5.  S::  Edga  vartax  right 

6  Jt  Join  tha  first  and  last  varticas  ot  tha  wire 

7.  *  Pull  tha  taca  lamina  towards  you. 

8.  S  Swaap  tha  squara  taca  into  a  very  thin  solid. 

9  —  T  Mova  tha  faca  away  trom  you  giving  tha  cuba  depth 

10  o/):l  Rotate  tha  cuba  to  a  more  familiar  position. 

Three  commands  that  have  not  bean  mentioned  yet  are:  "V"  vertex  body  creation,  "S"  sweep 

and  "J"  join  two  vertices  with  a  new  edge  Tha  "V"  command  takas  no  arguments  and  pushs  a  new 

body,  taca  and  vartax  into  the  stack  This  daganarata  point  polyhedron  satisfies  the  Euler  aquation 
F-E»V«2  (1-0»1«2)  and  is  always  placed  at  tha  world  origin.  Tha  tirst  three  swaap  commands  in  the 
example  sweep  a  vertex  polyhedron  into  a  wire  polyhedron  by  adding  a  new  vertex  and  a  new  edge 
(incidentally  preserving  Euler’s  aquation  as  do  all  GEOMED  commands).  Tha  wire-aweap  takes  a  vertex 
argument  trom  the  atack,  and  returns  the  new  vertex  to  the  stack  The  new  vertex  her  the  same  locus 
as  the  argument  vertex.  Attar  three  sides  ot  a  square  have  been  tornied,  the  "J"  command  creates  a 
new  (ace  and  a  new  adga  between  iha  tirst  and  last  vertex  of  the  wire  face.  T**  wire-join  case  ot  the 
nJ”  command  takes  a  vertex  argument  and  identifies  it  as  the  and  ot  a  wire  and  knows  enough  to  fetch 
the  other  end  oi  that  wire,  as  its  second  argument. 


1.12  M 'king  a  Solid  of  Rotation. 


A  solid  ot  rotation  can  be  made  by  sweeping  a  wira  face  into  a  sheet  (of  rotation)  and  by  dosing 
tha  sheet  with  the  "R"  command  (Rotation  Completion.  For  example  a  dumbbell  shaped  object  is 
formed  by  typing  the  following  commands: 

1.  V(((((:  Get  Vertex  to  starting  position. 

2.  S:)S)S;)S))))  Lower  bell. 

3.  S:)S)S;)t  Upper  Bell. 

4.  7aS(R!t  Rotate  wire  about  Y-axia  and  complete  solid. 
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1.13  Wire,  Lamina,  Sheet,  Eular  and  Solid  Polyhedra 

Tho  entities  being  created  and  altered  by  GEOMEO  are  representations  ot  polyhedra.  As 
already  mentioned,  a  polyhedron  is  comprised  ot  a  single  body  node  which  is  connected  to  a  ring  ot 
tace  nodes,  a  ring  ot  edge  nodes  and  a  ring  c*  vertex  nodes  The  nodes  are  tlxed  size  et  twelve  words 
per  node  and  all  the  topological,  geometric  and  photometric  data  tits  in  the  nodes  In  particular,  there 
are  no  variable  length  structures  such  as  tace  perimeter  lists;  hus  the  core  space  required  to-  e 
polyhedron  is  (B»F‘E»V)*I  2  words  ot  memory 

In  GEOMED,  several  classes  of  polyhedra  are  handled  The  most  general  class  allowed  are  Euler 
polyhedra  which  satisfy  the  relation  F-E*V»2*B-2*H;  where  B,  F,  E,  and  V  are  the  number  of  bodies, 
faces,  edges  and  vertices  in  the  model  and  H  is  the  genus  of  the  surface  ot  the  polyhedron  (which  is 

the  same  as  the  number  of  handles  or  holes)  The  editor  is  based  on  primitives  which  maintain  the 

Euler  relation  so  that  a  polyhedron  that  violates  the  Euler  relation  can  not  be  generated.  The  most 
restricted  polyderon  class  are  called  solid  convex-tace  polyhedra;  these  polyhedra  may  be  concave  but 
all  their  faces  must  be  convex  and  planar;  all  their  vertices  and  faces  must  have  a  valence  (number 

of  edges)  of  three  or  more;  and  no  edge  may  intersect  a  face  or  vertex  to  which  it  is  not  topologically 

linked  Solid  convex-taced  polyhedra  are  required  tor  efficient  and  accurate  operation  of  the  hidden 
line  eliminator. 

Intermediate  between  Eulerian  and  solid,  are  the  wire,  lamina  and  sheet  polyhedra  which  can  be 
made  by  sweep  commands  A  wire  polyhedron  is  Eulencr,  one  faced  with  linear  topology;  a  lamina  is  a 
two  faced  polyhedron  with  no  interior  edges  or  dangling  wire;  and  finally  a  sheet  is  an  array  ot  lemina. 
With  the  exception  of  sweeping  ruled  surfaces,  commands  for  manipulating  and  folding  sheets  are 
non-existent. 
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1.14  Body  Intersection,  Union  and  Subtraction 


Given  two  solid  polyhedra  in  the  top  o<  the  stack,  the  polyhedron  (or  polyhedra)  enclosing  the 
space  o<  their  intersection,  union  or  set  ditterence  can  be  obtained  by  typing  the  Vfl",  VU"  or  "oc-” 
commands  respectively.  A*  illustrated  in  the  lower  right  tigure,  a  polyhedral  model  o<  a  plastic  toy 
horse  can  be  made  by  applying  the  intersection  command  to  conet  of  silhouette  contours  of  video 
images  taken  trom  two  camera  positions. 


INTERSECTION 


WO  OPERANDS 


SUBTRACTION 


SILHOUETTE  CONE  INTERSECTION 


SUBTRACTION 


2.!  Jack. 


XCUB  2  2  2 

\\FF  >S*  >S*  >S*  >S*  >S*  >S*  B 


2.2.1  Torus 


2.2.2  Torus  using  iterated  sweeps. 


SECTION  2 


EXAMPLES 


The  examples  can  be  used  as  exercises  in  two  wayst  the  energetic  reader  can  glance  at  the 
figures  and  attempt  to  reproduce  the  results  on  his  own;  the  casual  reader  can  copy  the  answers  into 
the  computer  and  follow  the  action  a  step  at  a  time.  In  either  event,  one  should  look  at  sections  3 
through  7  for  commands  tk«{  have  not  yet  been  explained. 


V<« 

$*S*S* 

S*S*S*S* 

JT 

!\V 

eS)S)S)S) 

S)S)S)S) 

i>GT 


V:7oS*J 

ItSMftS) 

i>Gtl 


Make  lamina. 

Sweep  lamina  Into  ring. 
Glue  the  ends 


First  Vertex. 

Seven  more  vertices. 


Form  Lamina. 

Position  the  lamina. 

Sweep  the  face  around  the  Y-axis. 


Glue  the  ends  of  the  torus  together. 
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2.3  Soma  Cubes 

An  introduction  to  both  Soma  Cubes  and  the  Platonic  solids  can  be  found  i  i  Martin  Gardner's 
Second  Book  of  Mathematical  Pu7Tles  and  Diversions,  Simon  and  Schuster,  New  York,  1961.  The 
objects  are  shown  rotationally  displaced  from  the  position  in  whieh  they  are  constructed.  If  you  do  one 
object  after  another,  then  the  "FT”  should  not  be  repeated. 


rFXCUB  1  1  1 
>S*»S*3NS0MA1 


FFXCUB  1  1  I 
>S*S*»S*BNSOMA2 


FFXCUB  1  I  I 

>$*  >S*  >S*BNSOMA3 


FFXCUB  I  1  I 

<S*Afc.»T  S*BNSCMA4 


FFXCUB  1  I  1 

»S*»»S*Afc.*r,*BNS0MA5 


FFXCUB  1  1  1 

»$*»»S*Ai  ♦TS*<5-BNSOMA6 


FFXCUB  1  I  1 
<S*«<S*<S*BNS0MA7 
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2  4  The  Platonic  Solids. 

Regular  Tetrahedron,  edgf  length  of  SQRT(2). 


XCUB  I  1  1 
aJ.aa.1B  vJvv 
SKTSKTSKTKB 


Push  opposing  vertices  into  the  stack, 
Lop  off  the  opposing  vertices. 


Another  Regular  Tetrahedron,  edge  length  of  $QRT(3) 


XCYL  6  3  6*1  414 
>XB 


Three  sided  cylinder 
Pyramid  one  of  the  ends. 


Regular  Hexahedron,  edge  length  of  1. 


XCUB  1  1  1 


Very  easy 


Regular  Octahedron,  edge  length  of  SQRTO/2) 


XCUB  1  1  1 

fiO 


Face-Vertex  Dual  of  a  cube 


Regular  Icosahedron,  edge  length  of  6*$IN(n/5). 

Pentagonal  lamina 


i 


Prismoid  face  sweep 


Xcyl  3  5  0 

X.507*3 

>*XPRISM 

--nn/5 

oc*X  618*3 

i>oCS*to«s-B 


Regular  Dodecahedron,  edge  length  of  6/PHI 
(after  Euclid’s  classical  construction: 

Elements,  Book  XIII,  Proposition  17). 

\\  /  i  '  \ 

XGUB  6  6  6  Start  with  a  cube. 

^3X3  _ Midpoint  DDEL,  M'dedge  TDEL. 

Fdge\sweeps  to 
S:t*<S(**'l.M«'  \ 


midface. 


<SJM«<<$}ocT 

JM^MocTJ/J-J 

7.61.8034 

X0.309017*6 

/t(*T/t-:T/t;(B 


Join  the  two  pairs  of  midpoints 
Reciprocal  of  the  golden  mean,  PHi. 

SQRT(PHIT2  -  1/4  -  (1-PHI/2H2) 
Shrink  and  translate  the  six  new  edges. 
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2.5  A  Knot 


The  Knot  was  developed  by  visualizing 
the  connection  of  three  non-parallel  and  non-coplanar 
edges  of  a  cube,  as  in  the  second  Knot  figure 


XCUB 3  2  1 
7.100/3 

>i>2 

E(E:«TJ<S*B 

>A>Uv.. 

«KT 

eKTKTiveKTKB 
*cVl  2 
SKBI 


2.7  Yet  Another  Torus. 


V\:itJt/9 
9eS*!/S;S))) 
S::::::S(((JT 
-S**»i»»9«S*l 
G 


XCYL  1  8  6 
\6 

Q,/-»X1 

Soc))S«c))Soc)) 

Soc))S«c))S*c))BX3 

*:(o9C 

:-C-(l 

>i>eci 

>l>oCi 

GTGTG 


Straight  section. 

Tnree  quarters  of  a  turn. 
Symetry  on  a  cube 
Fetch  three  pairs  of  facet 

Glue  the  pairs  of  faces 


An  Odd  Shaped  Bloch  (illustrating  Kill  commands). 


\ 
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2.8  The  Pulgas  Water  Temple 


Ten  miles  north  ot  Stanford,  the  Pulgas  Water  Temple  marks  the  termination  of  an  aqueduct  that 
brings  water  from  '.he  Sierra  Nevada  to  San  Francisco.  This  example  illustrates  how  a  compliccted 


object  is  built  up  of  simple  polyhedra 


Base  of  Temple 

V:X5  Foundation  of  temple 

SsX0.2 

S)S;;S)S;;S)SX3  Jaggies  forming  steps 

;Tn40'  Se*  RDEL  to  40  degrees 

8oS)RT-X3  61  Sweep  out  a  solid  of  rotation. 

!( 

Top  of  Temple 
IVX0  6 

:S)))S;;S(((J  Make  rectangular  lamina 

tX3  5 

:n40' 

9fiSH>Gt/)  Sweep  lamina 

1X2  72 

) 

Columns  of  Temple 

XCYL  0  5  9  6  Make  first  column, 

69:1X3.5  position  column. 

>A49/3(<:rt20'  Taper  the  top  of  the  column 

Q®/\ 

C)P'C)r )  Make  eight  copies  of  the  column, 

C)C)C)C) 


k  •  _ 
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2.10  Video  Synthes'* 


The  "flO"  command  will  Ho  a  hidden  line  elimination  and  output  a  2-D  vector  based  image  format, 
V2D  file,  which  in  turn  is  suitable  input  to  a  program  .ailed  MKVIU  MKVIO  creates,  shades,  colors,  and 
dejaggies  television  pictures.  The  only  online  video  hardcopy  device  is  the  Xerox  Graphics  Printer.  A 
quick,  but  low  quality  XGP  video  image  (such  as  the  large  one  below  o<  .he  star  ship  Enterprise)  it 
obtained  by  typing  "R  XIPjLO.OjUKFILENAMEr  or  "R  XAP;I  0,us*<FILENAME>"  to  the  monitors  the 
smaller  picture  was  made  by  taking  a  Poioriod  picture  ot  a  video  display  screen.  XIP  and  XAP  ere 
underground  Xerox  document  format  ing  programs  which  wili  someday  be  superceded  by  the 
establishment  supported  program  nam>d  PUB  XiP  is  three  times  faster  than  XAP,  but  uses  twice  as 
much  core.  This  document  was  formated  and  printed  using  XIP 
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2.11  Video  Derived  Polyhedra 


One  way  to  make  a  polyhedron  from  a  video  image  is  lo  sweep  the  silhouette  of  ar.  intensity 
contour  from  the  program  CRE  (a  video  contouring  program).  The  CRE  commands  "T"  for  take,  ”CM  for 
contour  and  ’VO"  for  output  contoured  image  will  yield  a  disk  file  suitable  for  input  to  GEOMED  Using 
GEOMED  commands:  "fl\"  will  input  a  CRE  file  and  create  a  face,  edge,  vertex  date  structure  on  the 
now  camera  node  that  corresponds  to  the  contoured  image; 


0  TClOocOHAND.CRE 

1  /JIHAND.CRE 

2.  ocC. 

3.  XSIL  <ZMIN>  <ZMAX> 


CRE  Commands  to  take,  contour  and  output. 
GEOMED  input  from  CRE  file. 

Locate  a  suitable  contour  body  node. 

Sweep  out  silhouette  polyhedron. 


The  CRE  program  is  documented  in  Stanford  A.I  Memo  si 99,  titled  Image  Contouring  and 
Comparing’,  by  Baumgart  A  more  elaborate  example  of  video  assisted  drawing  is  demonstrated  by  the 
water  pump  below;  the  shape  of  the  base  and  the  holes  in  the  base  were  derive.d  from  a  video  imege. 
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GEOMETRIC  COMMANDS 

3  1  EUCLIDEAN  TRANSFORMATION  YS 

Translation,  <*  Rotation,  /3  Oilatior,  <  Reflection 
Transform  Minus  X-Axis  V  Plus  X-Axis 

Transform  Minus  Y-Axis  T  Plus  Y-Axis 

Transform  Minus  Z-Axis  Plus  Z-Axi< 

*T  T  anslation  Default  Rotation  Default. 

3  2  STRENGTHS  OF  TRANSFORMATION. 

3.2  1  Halva  a  Transformation  Strength 

"\"  Double  a  Transformation  Strength 

3.2  2  "\<expr>"  Sat  Translation  Strength,  TDEL 

"r.<axpr>"  Sat  Potation  Strength,  RDEL 

”7.<expr>"  Sat  Dilation  Strength,  DDEL 

3  2  3  "<digit>"  Sat  Transform  Strength  Immediate 

3.3  EUCLIDEAN  SWITCHES 

3.3  I  "F"  Stap  Frame  Switch  Forwards 

”/3F”  Stap  Frame  Switch  Backwards. 

3.3.2  ”0”  Toggle  Frama  Origin  Switch 

3.3  3  ”4A"  Stap  Axis  Counter 

334  "V"  Enable  Aii  Body  Motions. 

"*V"  Disable  Framo  Motion. 

"flVn  Disable  Vertex  Motion 
"<V"  Disable  Parts  Motion. 

3.4  THE  ITERATION  COUNTER 

"<digit>"  Accumulate  Iteration  Count 
"<return>"  Reset  Iteration  Count  to  Zero 

3.5  DIRECT  EUCLIDEAN  COMMANDS. 

3.5.1  "U"  Unmove  a  Body 

3.5.2  "X  PLACE  <X>  <Y>  <Z>" 

3.5.3  "X  ORIENT  <PAN>  <TILT>  <SWING>" 


GEOMETRIC  COMMANDS. 


3.1  EUCLIDEAN  TRANSFORMATIONS. 

Translation,  o t  Rotation,  fl  Dilation,  i  Reflection. 

Transform  Minus  X-Axis  ":H  Plus  X-Axis 

'•("  Transform  Minus  Y-Axis.  ")"  Plus  Y-Axis 

transform  Minus  Z-Axis.  Plus  Z-Axis. 

•T  Translation  Dotault.  "o"  Rotation  Default 

The  Euclidean  geometric  transformations  are  translation,  rotation,  dilation  and  reflection.  The 
entity  in  the  top  of  the  stack  is  transformed  by  typing  one  o  the  six  characters:  colon,  semicolon,  lett 
parenthesis,  right  parenthesis,  minus  sign  or  asterisk  The  characters  colon,  left  parenthesis  and  minus 
sign  transform  the  object  in  the  negative  direction  with  respect  to  the  X,  the  Y,  and  the  Z  a  es 
respectively  Tie  characters  semicolon,  right  parenthesis  and  asterisk  transform  the  object  in  the 
positive  direction  with  respect  to  the  X,  the  Y,  and  the  Z  axes  respectively  The  particular 
transformation  is  selected  by  keying  the  coKrol  bits:  none,  control,  meta  and  meta-control  which 
respectively  select  translation,  rotation,  dilanon  and  reflection.  Finally,  the  no-control-bits  ctT^  can  be 
torced  to  hi  rotation  by  the  "fiM  rotation  default  command,  or  translation  by  the  "P  tra*'.etion  default 
command 

Translation  moves  the  top  entity  in  th*  stack  in  the  direction  specified  by  one  unit  of  translation 
strength,  TDEL  Rotation  rotates  the  entity  about  the  axis  specified  by  one  unit  of  rotational  strength, 
RDEL  Positive  rotations  are  counter  clockwise  and  negative  rotations  are  clockwise 

Dilations  and  reflections  refer  to  a  three  axis  count  selector  State  1  causes  dilation  (reflection) 
to  be  done  on  the  specified  axis,  dilation  state  2  causes  dilation  (reflection)  on  the  two  axes  not 
indicated,  and  state  3  causes  dilation  (relfecticn)  on  all  the  axas.  The  axis  count  selector  is  advanced 
by  typing  ”4A’V  The  state  ot  the  selector  Is  displayed  as  a  digit  1,  2  or  3  just  to  the  right  of  the 
dilation  strength’s  per  cent  sign  in  the  editor  statue  in  the  upper  right  of  the  display  screen. 

When  the  dilation  strength,  DDEL,  is  less  than  1007.  a  positive  dilation  will  scale  the  entity  by 
1  /DDEL  and  a  ne;«<ive  dilation  will  scale  the  entity  by  DDEL.  Positive  and  negative  keyings  make  no 
difference  in  the  execution  of  a  reflection. 


3.2  STRENG1 HS  OF  TRANSFORMATION 

3  2.1  7"  Halve  a  Transformation  Strength. 

"\"  Double  a  Transformation  Strength. 

The  strength  ot  a  Euclidean  transformation  can  be  halved  or  doubled  by  keying  the  transform's 
control  bits  and  by  striking  slash  or  back  slash  respectively. 
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3  2.2  "X<real  expression)"  Sat  Translation  Strength,  TDEL. 

"rtcreal  expression)"  Sat  Rotation  Strength,  RDEL. 

”7.<real  expression)"  Sat  Dilation  Streng'h,  DDEL. 

The  strengths  of  the  Euclidean  transformations  can  be  entered  nume-ically  by  typing  "X”,  n  or 
"7."  followed  by  an  arithmetic  expression  of  numerical  constants.  The  simple  exnress'on  scanner  can 
take  parenthesis  in  the  usual  precedence  order;  the  scanner  also  evaluat  »s  the 

pi  character,  "n",  to  3  1  *1 5927;  numbers  suHixed  with  the  inch  mark  double  quote  (  )  are  divided  by 
twelve;  lumbers  suffixed  with  a  left  single  quote  (’)  are  multiplied  by  l.’4532$t-2  which  converts 

degrees  into  radians 

3.2.3  "<digits>"  Set  Transform  Strength  Immediate. 

The  strength  of  a  Euclidean  transformation  can  be  set  by  keying  the  Transform’s  control  bits  and 
by  striking  a  digit  from  zero  to  nine  Keying  "«digit>"  sets  the  strength  of  translation;  a  digit  without 
meta-control  bits  contributes  to  the  iteration  count  For  Translation:  "<0"  sets  TDEL  to  1/16  of  a  foot, 
"<4"  sets  TDEL  to  one  Foot,  and  "<9"  sets  TDEL  to  32  Feet  That  is,  «digit>  sets  TDEL  to 
2  0T«digit>-4)  feet  For  Rotation:  V9"  sets  RDEL  to  n/2,  V8"  sets  RDEL  to  n/4,  and  so  on  by 
halves.  For  Dilation:  "/tl"  sets  DDEL  to  107.,  "/J2"  sets  DDEL  to  207.  and  so  on 


3.3  EUCLIDEAN  SWITCHES. 

3.3.1  "F"  Step  frame  switch  forwards 

"/IF"  Step  frame  switch  backwards. 

There  are  four  frames  of  reference:  world  frame,  body  frame,  relative  frame  and  camera  frame 
The  world  frame  is  that  in  which  all  coordinates  are  stored;  the  world  frame  Is  the  natural  direct  frame 
of  reference,  all  the  other  frames  being  represented  in  world  frame  coordinates  by  a  frame  node 
which  contains  the  origin  location  and  axes  orientation  of  secondary  frames  In  particular,  each  body 
and  camera  has  a  frame  node,  which  determine  a  camera  or  a  body  frame  of  reference  that  translates 
and  rotates  when  Euclidean  transformations  are  applied  to  that  body  or  camera  The  relative  frame 
mode  is  a  catch  all;  when  a  body  is  in  the  top  of  the  stack,  its  relative  frame  is  that  of  the  body  of 
which  it  is  a  part;  when  a  face  is  in  the  top  of  the  stack,  its  relative  frame  is  a  special  face  frame  with 
2. axis  parallel  to  the  face’s  outward  pointing  normal.  The  "F"  command  steps  the  frame  switch 
selector  forwards,  "/IF"  steps  the  frame  switch  selector  backwards.  The  state  of  the  frame  switch 
selector  is  displayed  in  the  status  in  the  upper  right  of  the  display  screen. 
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3  3.2  "Q"  Toggle  Frame  Origin  Switch 

Euclidean  transformations  in  world  Irame  can  be  done  with  rerv:t  to  the  world  origin  or  with 
repect  to  the  origin  of  the  entity  being  transformed  depending  on  the  state  of  the  FRMORG  switch.  In 
particular,  FRMORG  affects  world  frame  rotations:  FRMORG  true  causet  rotation  about  a  world  axis  thru 
the  world  origin;  FRMORG  false  causes  rotation  about  an  axis  parallel  to  a  world  axis,  but  passing  thru 
the  body  origin.  The  FRMORG  switch  is  flipped  by  the  ”Q"  command.  The  state  of  FRMORG  is  indicated 
by  an  asterisk  in  the  status  display;  the  asterisk  is  present  when  FRMORG  is  true  and  absent  when 
FRMORG  is  false 

3  3.3  "/SA"  Step  Axis  Counter 

The  three-state  switch  named  AXECNT  affects  dilations  and  reflections  State  *1  indicates 
dilation  (reflection)  only  on  the  specified  axir.  State  «2  indicates  oration  (reflection)  on  the  two  axes 
not  spe-ilied  State  »3  indicates  dilation  (reflection)  on  all  three  axes  The  state  of  the  AXECNT  switch 
is  indicated  by  a  digit  to  the  right  of  the  dilation  strength’s  percent  sign  In  the  status  display.  AXECNT 
is  cycled  forward  by  the  M/dA"  command 


3  3  4  "V"  Enable  All  Body  Motions 

"ocV”  Disable  Frame  Motion 
"^V”  Disable  Vertex  Mohon. 

"<V"  Disable  Parts  Motion. 

Applying  a  Euclidean  transformation  to  a  body  means  applying  the  tranform  to  the  vertices, 
frame  and  parts  of  that  body  Each  of  these  three  phases  of  body  transformation  can  be  individually 
disabled  by  the  "V"  command  with  the  appropriate  combination  of  meta-control  bits.  With  no 
meta-control  bits,  the  "V"  command  resets  alt  the  body  disable  bits.  Transforming  a  fully  disabled  body 
is  a  no-operation. 


3.4  THE  ITERATION  COUNTER 

"<digit>"  Accumulate  Iteration  Count. 

"<return>M  Reset  Iteration  Count  to  Zero 

Digits  typad  without  control  keys  are  accumulated  into  an  iteration  counter.  The  iteration  count 
is  cleared  by  typing  a  carriige  return  The  count  applies  to  Euclidean  transformations  and  sweeps. 
The  ability  to  iterate  and  to  do  macros  is  not  developed  because  of  the  existence  of  GEOMED  imbedded 
in  LISP  which  provides  better  interactive  programming  facilities  than  would  be  possible  under  the 
present  character  command  scanner  (It  ia  my  design  philosophy  that  Interactive  geometric  editing  can 
In  (act  be  kept  distinct  from  interactive  programming). 
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3  5  DIRECT  EUCLIDEAN  CO  ^MANDS. 

3.5  1  "U"  Unmove  a  Body. 

This  command  applies  th.»  inverse  of  the  given  body’s  frame  of  reference  to  the  body  itself 
This  has  the  effect  of  undoing  any  translations  and  rotations  that  nave  been  app!,ed  to  the  bodv;  that  Is 
the  body’s  frame  is  ji  ought  ba’.K  to  be  coincident  with  the  world  frame  of  reference.  Thus  a 
polyhedral  body  can  be  constructed  in  a  standard  oiientation;  then  rotated  randomly  for  inspection;  and 
then  be  wrought  back  to  iti  original  orientation  for  further  editing. 

3  5  2  "X  PLACE  <X>  <Y>  <Z>" 

The  location  of  the  body,  camera  or  vertex  in  the  top  of  the  stack  is  placed  at  the  given  world 
coordinates. 

3.5.3  "X  ORIENT  <pan>  <tilt>  <swing>" 

The  orientation  of  the  given  body  or  camera  is  set  to  the  specified  values. 


SECTION  4 


TOPOLOGICAL  COMMANDS. 


4  1 


FIVE  EASY  CREATIONS 

4  1  1  "oo"  Instant  Cube. 

4.1.2  Voo"  Instant  Torus. 

4  1  3  "X  CUBE  <DX>  <DY>  <DZ>" 

4.1  4  "X  CYLN  <RADIUS>  <N-SIDES>  <DZ>" 

4  1  5  "X  BALL  <RADIU$>  <M-LONGITUDES>  <N-LAT1TUDES>" 


4.2 


COPY,  KILL 
4  2.1 
4  2  2 
4  2  3 

4 


AND  DUAL 
"C"  Copy. 

"K"  Kill 

VK"  Edge-Vertex  Kill 
"/3D"  Dual 


4  3  SWEEP  COMMANDS 

4  3  1  "S”  Sweep 

4.3  2  VS"  Pyramid 
4  3.3  "R"  Rotation  Solid  Completion. 

4.3  4  "X  SILHOUETTE  <ZMIN>  <ZMAX>" 
4  3  5  "X  PRISMOID” 

4  4  THE  EULER  COMMANDS 


4  4,1 

S*yH 

Make  Vertex  Body. 

4  42 

»l£Sf 

Make  Edge  and  Virtex 

4  4.3 

"M" 

Midpoint  an  Edge 

4  4  4 

»»  jM 

Join  Vertices. 

445 

"G" 

Glue  Faces 

BODY  INTERSECTION  COMMANDS 

4.5  1 

Vfl" 

'  Body  Intersection. 

4.5  2 

VU" 

1  Body  Union. 

4  53 

V-" 

Body  Subtraction 

454 

•  t  M 

Evert  Body  Surface  Orientation. 

45  5 

•sp 

Invert  Edge  Linear  Orientation. 

4  5  6  Make  Convex 

4  5  7  V|"  Edge  Slurp. 

4.6  CUT  COMMANDS 

"X  CUT  <X>  <Y>  <Z>" 
VX  CUT  <X>  <Y>  <Z>" 
”/3X  CUT  <X>  <Y>  <Z>" 
"(X  CUT" 

4  7  PARTS  TREE  COMMANDS 
"A"  Attach. 

"D"  Detach. 


Cut  Bodies,  Faces  and  Edges. 
Cut  Faces  and  Edges. 

Cut  Edges. 

Kill  Temporaries  (Uncut). 
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4.1  FIVE  EASY  CREATIONS. 

4.1.1  "co"  Instant  Cub*. 

Th#  instant  cub*  command  plac*s  a  command  string  for  making  a  particular  cub*  into  th* 
t*l*typ*  buffer  Th*  purpose  of  this  command  is  to  make  a  demonstration  object 

4.1.2  "ecco"  Instant  Torus 

The  instant  torus  command  places  a  command  string  for  making  a  particular  torus  into  tho 
teletype  buffer.  Th*  purpose  of  this  command  is  to  make  a  demonstration  object 

4  1.3  ”X  CUBE  <DX>  <DY>  <DZ>" 

The  CUBE  command  makes  a  right  rectangular  prism  with  width  height  and  depth  as  given  in  the 
three  arguments  Th*  body  nod*  of  th*  cub*  is  pushed  into  th*  stack,  and  th*  cub*  is  located  at  th* 
world  origin.  Th*  absolute  value  of  th*  arguments  is  taken  so  that  the  cub*  is  always  solid.  A  zero 
<DZ>  returns  a  rectangular  lamina  rather  than  a  cub* 

4  14  "X  CYLN  <RADIU$>  <N-SIDE$>  <DZ>" 

Th*  CYLN  makes  a  right  prism  that  approximates  a  circular  cylinder.  A  zero  <DZ>  argument 
returns  a  circular  lamina  rather  than  a  cylinder  Th*  <N-sid*s>  argument  is  forced  to  be  at  least  thr**. 

4  1.5  "X  BALL  <RADIU$>  <M-LONGITUDE$>  <N-LATITUDE$>" 

Th*  BALL  command  makes  a  polyhedron  that  approximates  a  sphere  Th*  <M-Longitud*s>  end 
<N-Latitud*s>  are  forced  to  be  at  least  three  and  two  respectively. 


TOPOLOGICAL  COMMANDS. 

4  2  COPY,  KILL  AND  DUAL 
4  2.1  "CM  Copy. 

This  command  copies  the  body  or  face  from  the  top  of  stack  in  a  reasonable  manner  and  pushs  it 
down.  The  copy  of  a  body  includes  all  the  parts  of  that  body  The  copy  of  a  face,  creates  a  two-taced 
body  lamina  coincident  with  the  given  face 

4.2.2  "K"  Kill 

This  command  takes  the  top  body,  face,  edge  or  vertex  and  attempts  to  delete  it  in  a  reasonable 
manner.  Kill  of  a  body  deletes  it  and  all  its  parts.  Kill  of  a  face  removes  the  given  face  and  all  its 
edges  and  vertices  but  one  vertex,  which  is  placed  in  the  center  of  the  given  face  and  is  returned  to 
the  stack.  Kill  of  an  edge  removes  the  given  edge  and  its  negative  face,  NFACE(E)  Kill  of  a  vertex 
removes  the  vertex  and  all  its  edges  and  faces  but  one  face,  which  is  returned  to  the  stack.  The  kill 
operation  is  not  defined  in  cases  which  would  leave  one-sided  faces  or  dangling  edges;  however  the 
necessary  trihedral  restrictions  are  not  imposed  so  that  certain  illegal  kills  are  possible  and  other 
illegal  kills  are  fatal 

4.2.3  VKH  Edge-Vertex  Kill. 

The  VK"  kill  of  an  edge  removes  the  edge  and  its  negative  vertex,  NVT(E);  the  positive  vertex, 
PVT(E),  is  repositioned  to  be  at  the  center  ot  the  original  edge.  The  PVT(E)  vertex  It  returned  to  the 
stack 


4  2  4  ”40"  Dual 

The  "4DM  command  makes  the 
face/vertex  dual  of  a  body;  that  is  all 
the  faces  become  vertices  and  all  the 
vertices  become  faces  This  command 
will  turn  dodecahedrons  into 
icosahedrons  (or  jacks  into  horny 
octahedrons)  as  illustrated 
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4.3  SWEEP  COMMANDS 
4.3.1  "S"  Sweep. 

"/iS"  Sweep  Cylinder,  Edges  Nol  Sharp” 

This  command  sweeps  a  face  into  either  a  shoot  or  a  solid  depending  on  tho  NCNT  tho  taco. 
If  tho  NCNT  is  zero,  thon  "S”  returns  a  now  face  coi>ic>dont  with  tho  given  taco  and  connected  to  it  by 
r*aw  swoop  edges  and  rectangular  swoop  faces  forming  a  prism.  When  tho  NCNT  is  non-zero,  only  tho 
first  NCNT  edges  of  the  argument  face’s  perimeter  are  swept  into  nev»  faces,  for  tho  sake  of  creating 
solids  of  rotation.  The  "S"  command  applied  to  a  vertex  sweeps  out  a  new  vertex  and  a  now  odge. 
Tho  "/IS"  command  is  the  same  as  "S"  except  that  the  new  swe  >p  edges  are  marked  with  tho  NSHARP 
(not  sharp)  bit 


4.3.2  VS”  Sweep  Pyramid. 

"<S"  Sweep  Pyramid,  Edges  Not  Sharp 

Given  a  face,  VS"  will  create  a  peak  vertex  and  place  it  in  the  center  of  the  face  connected  by 
an  edge  to  each  of  the  face’s  original  vertices  The  peak  vortex  is  returned  to  the  stack.  Given  a 
vertex,  the  pyramid  command  'orces  all  the  faces  of  that  vertex  to  be  triangutar  (as  if  the  given  vertex 
were  a  peak  vertex  of  a  pyrarid) 

4.3.3  "R"  Rotation  Solid  Completion. 


After  a  wire  has  been  swept  around,  you  have  a  shell  of  rotation.  To  change  a  shell  into  a  solid 
all  that  remains  to  be  done  is  do  a  series  of  J  commands  on  the  leading  and  lagging  vertices  of  the 
shell  The  R  command,  using  the  NCNT  to  step  arounJ  the  pole  caps,  calls  the  J-command  for  all  tho 
necessary  pairs  of  vertices.  The  sweep  face  is  taken  as  an  argument  and  nothing  is  returned. 

4  3  4  "X  SILHOUETTE  <ZMIN>  <ZMAX>" 

This  command  sweeps  a  silhouette  lamina  body  into  a  cone  between  -<zmin>  and  -<zmax>  on  tho 
Z-axis  of  the  now  camera.  The  minus  Z  half  space  is  the  one  that  contains  tho  pbjects  visible  from  tho 
camera;  that  is,  the  camera’s  principle  ray  is  the  minus  Z-axis  ray. 

4  3.5  "X  PRISMOID" 

This  command  is  like  the  face  sweep  command  except  that  the  diagonal  edges  are  provided 
across  all  the  new  swe  >p  face  rectangles  forming  a  prismoid  of  triangles  rather  than  a  prism  of 
rectangles.  (See,  tho  icosahedron  example,  2.4). 


24 


TOPOLOGICAL  COMMANDS. 


4.4  THE  EULER  COMMANDS. 

4  4.1  "V"  Make  V.rtex  Body 

"  /IS"  Make  Body  nod* 


This  command  creates  a  polyhedron  consisting  of  one  vertex  and  one  face  The  vertex  is  placed 
at  the  world  origin.  The  V  command  takes  no  arguments  and  leaves  the  new  body,  face  and  vertex  on 
the  stack  with  the  vertex  on  top.  The  "flS"  command  will  make  a  naked  body  node,  th*t  is  a  body  with 
no  faces,  edges  or  vertices. 

4.4  2  "E"  Make  Edge  and  Vertex 

This  command  creates  a  new  edge  and  a  new  vertex  starting  from  an  old  vertex  The  E 
command  requires  two  arguments,  the  top  argument  is  the  Md  vertex  and  the  second  argument  must  be 
one  of  the  faces  to  which  the  vertex  belongs  The  raw  edge  and  vertex  become  associated  with  the 
given  face. 

4  4  3  ’’M"  Midpoint  an  Edge. 

This  command  takes  an  edge  argument  and  creates  a  new  edge  and  a  now  vertex  The  new  mid 
vertex  is  positioned  along  the  edge  in  proportion  to  the  value  of  DDEL  Type  the  commands  "<5M"  in 
order  to  make  a  midpoint  that  is  geometrically  in  the  middle  of  the  given  edge 

4  4  4  "J"  Join  Vertices. 

This  command  creates  a  new  face  and  a  new  edge  The  "J"  command  has  two  forms  The 
general  form  of  the  "J"  command  expects  two  vertices  of  the  same  face  to  be  given  on  the  top  of  the 
stack,  and  it  returns  in  their  place  a  new  edge  and  a  new  face  with  the  edge  on  top  The  wire  form  of 
the  ”J”  command  applies  only  to  a  face  that  doesn't  have  a  dosed  perimeter  The  wire  "J”  returns  the 
other  end  of  the  wire  In  the  top  of  stack  and  leaves  the  second  argument  unchanged. 

4  45  ”G"  Glue  Faces 

This  command  takes  two  faces  from  the  top  of  the  stack.  The  faces  should  be  of  opposite 
orientation,  they  should  have  the  same  number  of  vertices,  and  the  vertices  should  be  nearly 
coincident.  The  two  faces  are  deleted  along  with  all  the  edges  and  vertices  of  the  second  one  nf  them. 
If  there  were  two  bodies  before,  then  one  will  remain;  as  a  body  glued  to  itself  forms  a  hole  (or 
handle)  yielding  a  polyhedral  surface  of  genus  one  greater  than  before.  In  either  ease,  the  glue 
command  returns  the  body  of  the  faces  so  formed. 
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4.5  BODY  INTERSECTION  COMMANDS. 

4  5.1  "*<0"  Body  Intersection. 

Given  two  different  bodies  from  the  top  of  the  stack,  if  the  intersection  of  the  space  endowed  by 
their  surfaces  is  not  empty  a  new  polyhedron  will  be  formed  to  represent  the  surface  of  the  space  of 
Intersection;  and  the  giver,  bodies  will  be  killed. 

4.5.2  "ocU”  Body  Union 

Given  two  different  bodies  from  the  top  of  the  stack,  if  the  union  of  the  space  enclosed  by  their 
surfaces  is  simply  connected  (that  is  a'la  de  Morgan:  the  intersection  of  the  space  enclosed  by  thei" 
surfaces  is  not  empty);  then  a  new  polyhedron  will  be  created  representing  the  surface  of  the  union  of 
the  enclosed  spaces  of  the  given  bodies  The  given  bodies  will  be  killed 

453  Body  Subtraction. 

Subtract  the  top  of  the  stack  body  from  the  body  second  in  the  stack  (where  subtraction  means 
union  of  the  evert  of  the  top  body  with  the  second  body) 

4  5  4  Evert  Body  Surface  Orientation. 

GEOMED  polyhedra  have  an  inside  and  an  outside  irrespective  of  enclosing  a  finite  positive 
volume;  that  is,  a  thing  that  appears  to  be  a  cube  can  either  be  a  so' d  in  space  or  n  space  in  a  solid. 
The  evert  command  turns  solids  into  holes  and  holes  into  solids.  Holes  are  defined  os  polyhedra  with 
negative  volume 

4.5  5  "I"  Invert  Edge  Linear  Orientation. 

Edges  are  directed  vectors  w>th  a  negative  vertex  and  a  positive  vertex  The  "f  command  flips 
the  linear  orientation  of  an  edge  by  swapping  its  vertices,  faces  and  wings  (edge  wings  are  discussed 
in  part  II) 

4.5.6  "I"  Make  Convex 

This  command  may  be  applied  to  a  face  or  a  body.  All  the  faces  referred  to  will  be  split  into 
triangles. 

4  5.7  "oc|"  Edge  Slurp 

This  command  will  attempt  to  remove  or  darken  the  visually  unaesthetic  edges  that  arise  from 
the  "I"  make  convex  command  The  edges  slurped  are  the  ones  with  dihedral  angles  of  almost  pi,  and 
with  wing  angles  that  sum  to  less  than  pi  at  each  vertex. 
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4.6  CUT  COMMANDS 

"X  CUT  <X>  <Y>  <Z>" 
VX  CUT  <X>  <Y>  <Z>" 
”/3%  CUT  <X>  <Y>  <Z>" 
"<X  CUT" 


Cut  Bodies,  Faces  and  Ed(es. 
Cut  Faces  end  Edges 
Cu!  Edges 

Kill  Temporaries  (Uncut) 


The  cut  command  argument  specifies  a  cutting  plane  in  terms  of  a  vector  from  the  world  origin; 
the  direction  of  the  vector  is  normal  to  the  desired  plane,  and  the  magnitude  of  the  vector  is  the 
distance  of  the  origin  from  the  desired  plane 


4  7  Parts  Tree  Structure  -  The  Attach  and  Detach  Commands 

"A"  ATTACH 

"D"  DETACH 

The  parts’  tree  commands  "A"  attach  and  and  "D”  detach,  allow  bodies  to  be  connected  into  a 
tree  structure  without  affecting  their  faces,  edges  or  vertices.  The  "A"  command  links  the  body  in  the 
top  of  the  stack  to  the  body  in  the  second  stack  position  as  a  sub-part  (or  child).  The  detach  command 
unlinks  a  body  from  its  parent.  Certain  operations  such  as  the  Euclidean  transformations  apply  to  a 
body  and  all  its  descendants.  If  the  top  entities  of  the  stack  are  not  bodies,  then  these  commands  are 
no-operations.  Because  of  the  implementdion,  the  parts  structure  is  always  kept  at  a  tree; 
circularities  and  incest  are  prevented. 
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INPUT/OUTPUT  COMMANDS. 


"I"  input  B3D  (ile 
"o<l"  input  CAM  file 
”/3l"  input  CRE  film 
"<l"  input  GEM  fil*. 


"0"  output  B3D  file 
VO"  output  CAM  fil«. 
VO"  output  V2D  fil* 
"(0"  output  GEM  fil* 


”/3Z"  take  commands  from  GEO  fil* 

"P"  output  PLT  fil*  of  current  display  buff*r. 


5  I  I/O  COMMANDS. 

Ti  e  "I"  and  "0"  er*  fh*  commands  for  input  and  output  Th*r*  ar*  two  fil*  formats  for 
polyhedra  named  B3D  and  GEM  Th*  plain  "0"  command  will  output  a  body  (and  all  its  parts)  from  th* 
top  of  th*  stack  into  a  B30  fil*  Th*  plain  "I”  command  will  input  a  body  (and  all  its  parts)  from  a  B30 
fii*  end  will  push  it  on  the  stack.  Th*  "od"  and  "o<0"  input  and  output  CAM  fibs  to  and  from  th*  nod* 
of  the  "now"  camera  Th*  final  simpl*  I/O  command  is  "P"  which  cr*ats  a  plot  fil*  of  th*  current 
display 


The  "<l"  and  "<0"  commands  are  nearly  identical  to  th*  "I"  and  "0"  commands,  except  that  they 
read  i.id  write  more  of  the  contents  of  each  body,  fac*,  edg*  and  vertex  nod*  for  th*  sak*  of  GEOMES 
(SAIl,  and  GEOMEL  (LISP)  users  Specifically,  words  0  and  8  of  *ach  nod*  is  included  in  th*  GEM 
format  Onlin*  GEOMES  and  GEOMEL  documentation  can  b*  found  under  *  WRU[GEM,HE]oSAIL. 


Th*  meta  I/O  command'  provide  an  indirect  method  of  getting  video  images  into  and  out  of 
OEOMED  On  the  input  side,  a  television  image  must  first  ba  converted  into  a  lin*  drawing  using  th* 
program  CRE  which  creates  CRE  files;  on  th*  output  side,  lin*  drawings,  V2D,  are  converted  into 
televsion  pictures  using  the  program  MKVID.  Th*  '/II"  command  inputs  a  CRE  film  of  images  and  places 
the  images  on  the  now-cam*ra’s  node.  Th*  "/30"  command  do*s  a  hidden  lin*  elimination  and  a 
photometric  simulation  (shines  th*  sun  on  all  th*  visible  faces)  in  order  to  create  a  V2D  fil*  (vector* 
2-D)  for  th*  sak*  of  MKVID.  Further  details  on  CRE  and  *4rvID  ar*  available  from  th*  system’*  HELP 
command 
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INPUT/OUTPUT  COMMANDS. 


5.2  ONLINE  PLOT  FILE  HARDCOPY:  PLTVEC,  XAP  AND  XIP 


There  are  two  online  hardcopy  plotting  devices:  the  Xerox  Graphics  Printer,  XGP  and  the 
Calcomp  plotter.  A  plot  tile  (which  is  a  display  butter)  can  be  plotted  on  tho  Calcomp  by  running  the 
program  PLTVEC.  PLTVEC  tirst  asks  for  point  vector  default:  REGULAR,  DASHED  or  VECTOR;  type  the 
letter  "R"  or  just  type  a  carriage  return  Next  PLTVEC  asks  tor  a  scale  size;  type  a  real  number 
between  0  1  and  2  5  A  scale  1.0  will  yield  a  plot  upproxima'ely  the  size  ot  tho  physical  display 
screen,  10  inchs  on  a  side  Next  PLTVEC  dsks  for  the  plot  file  name,  after  which  the  plot  begins 
When  the  plot  is  completed,  the  question  move  penM  appears  and  can  be  answered  with  the  letters 
"L"  for  left,  "RM  for  right,  "IT  for  up  and  MD"  for  down  On  the  other  hand,  in  order  ♦o  get  an  XGP 
copy  of  a  plot  (or  even  a  video  file);  type  ”R  XAP;L0,0;*<file>;”  or  MR  XIP;L0,0$*<fik>$“.  Futher 
details  on  XAP  and  XIP  are  available  from  the  system  HELP  command 


< 


5.3  VIDEO  IMAGE  DISPLAY:  DDVID. 

After  a  V2D  file  is  converted  into  i  television  file  by  the  program  MKVID;  the  picture,  which  is 
in  standard  Hand/Eye  format,  may  be  displayed  on  the  video  synthesizer  via  the  Data  Disc  using  the 
program  DDVID  To  display  a  television  image  using  DDVID,  type  "R  DDVID  <return>  E  <return> 
l<filename>  <return>  R<return>"  DDVID  will  type  a  list  of  its  commands  in  response  to  a  question  mark. 


5  4  GLOMED  COMMAND  FILES 

Contrary  to  its  design  philosophy,  GEOMED  will  accept  commands  from  a  file  The  proper  design 
philosophy  encourages  the  would  be  isometric  programmer  to  use  the  LISP  embedded  or  the  SAIL 
embedded  version  of  GEOMED  notation  ralher  than  the  syntactically  weak  single-character  jump-table 
notation  A  command  file  is  executed  by  the  "ftl"  command  which  will  ask  for  a  file  name.  The  file 
should  have  no  line  numbers.  Comments  may  be  included  among  the  commands  prefixed  by  H3M  and 
terminated  by  a  carriage-return  and  lira-feed.  A  not3”  comment  prefix  will  cause  the  comment  to  be 
typed  out;  the  "fl3"  comment  prefix  will  cause  GEOMED  to  wait  for  the  operator  to  type  a  character; 
and  the  "GM  comment  prefix  will  both  print  the  comment  and  wait. 
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SECTION  6 


EDITOR  CONTROL  COMMANDS. 


6  I  PROGRAM  CONTROL 

6  1  1  "<E"  Exit  GEOMED. 

612  ”oc»"  Enter  DDT. 


6.2  STACK  COMMANDS 


6.2  1. 


6  2  2 
6  2  3 
6  2  4 


Swap  First  and  Second  Elements  of  Stack, 
"o <**"  Swap  First  and  Third  Elements  of  Stack 
" fl»"  Swap  First  and  Last  Eler  .nts  of  Stack 

Swap  Second  and  Third  Elements  of  Stack. 
"I”  Duplicate  Push  Stack  Down 
"T”  Discard  Pop  Stack. 

Vi"  Rotate  the  Stack  Down. 

VT"  Rotate  the  Stack  Up 

“®"  Push  Universe  Node  into  the  Stack 

VC"  Push  the  Now  Camera  into  the  Stack. 


6.3  BODY  NAMING  AND  RETRIEVING 


6  3  I  "N"  Name  Body 

6.3  2  "B"  Body  Get 

6.3.3  VB"  Body  Retrieval  by  Name  or  by  Numeral. 

6  4  FACE  AND  VERTEX  PERIMETER  TRAVELING. 

"  "  Fetch  Counter  Clockwise 
Fetch  Clockwise 
•V  Fetch  Other 

VV<n>"  Fetch  Nth  Vertex  of  a  Body 


6.5  LINK  FOLLOWING  COMMANDS. 


"<"  NFACE  Link. 
"<"  NED  Link, 
"v"  NVT  Link 
"fT  DAD  Link 
"c"  BRO  Link 
•v"  ALT  Link 
V  CW  Link 


">"  PFACE  Link. 
T  PED  Link 
"a"  PVT  Link 
"U"  SON  Link, 
"s"  SIS  Link 
ALT2  Link 
CCW  Link. 
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6.1  PROGRAM  CONTROL 

6.1.1  ”<EM  Exit  GEOMED. 

Exit  the  GEOMED  editor.  Returns  control  to  monitor  levol  or  to  user  program  levfcl  When 
embedded,  GEOMED  returns  the  entity  at  the  top  of  its  stack  to  its  caller  as  its  value 

6.1.2  "©**"  Enter  DDT 

Enters  DDT  if  it  exists  The  SYS  versions  of  GEOMED  never  have  DDT;  the  versions 
GEOMED  DMP[GEM, HE]  and  G  DMP[GEM,BGB]  will  usually  have  DDT  (which  is  actually  a  Swmehart 
RAID);  and  a  GEOMES  core  image  has  DDT  depending  on  how  the  compile  and  load  was  done  A  DDT 
’VP"  command  will  continue  execution  in  the  GEOMED  listen  loop 

6  2  STACK  COMMANDS 

6.2.1  'V  Swap  First  and  Secord  Elements  of  Ihe  Stack 
"oc*"  Swap  First  and  Third  Elements  of  the  Stack. 

"/J*"  Swap  First  and  Last  Elements  of  the  Stack. 

"*♦*"  Swap  Second  and  Third  Elements  of  the  Stack 

GEOMFD  commands  take  their  arguments  from  and  leave  their  results  in  a  pushdown  stack  of 
bodies,  faces,  edges  and  vertices  The  contents  of  the  stack  are  displayed  on  the  left  hand  side  of  the 
display  screen  The  swap  commands  exchange  the  indicated  elements  of  the  stack  if  they  exist.  The 
stack  can  hold  one  hundred  entities,  although  only  the  top  thirty  elements  will  be  displayed 

6  2.2  "1"  Duplicate  Push  Stack  Dowv 
"T"  Discard  Pop  Stack. 

The  "i"  command  push  the  stack  down  and  places  a  duplicate  of  the  previous  top  of  stack  into 
tho  top  of  stack.  The  "T"  command  pops  the  stack  discarding  the  top  element. 

6.2.3  'VI"  Rotate  the  Stack  Down. 

'VTH  Rotate  the  Stack  Up 

The  rotate  stack  commands  preserve  the  number  of  elements  in  the  stack.  Rotate  down  push© 
the  stack  and  moves  the  last  element  to  the  top.  The  rotate  up  pop  the  stack  and  moves  the  previous 
top  to  the  bottom 

6.2.4  'V  Push  Universe  Node  into  the  Stack. 

'VC"  Push  the  now  camera  into  the  Stack 

These  two  commands  require  no  arguments,  but  merely  push  the  Universe  node  or  the  current 
camera  into  the  stack,  so  that  node  linking  can  be  started. 
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6.3  BODY  NAMING  AND  RETRIEVING. 

6  3.1  "N"  Name  Body. 

This  command  accepts  a  string  ot  j p  to  ten  characters  typed  as  a  name  for  the  body  in  the  top 
of  the  stack;  any  characters  can  be  used  in  the  name,  \he  named  is  terminated  by  a  carriage  return. 

6.3.2  "B"  Body  Get 

This  command  will  replace  the  edge,  face,  or  vertex  in  the  top  of  the  stack  with  the  body  to 
which  it  belongs. 

6.3  3  "ecB"  Body  Retrieval  by  Name  or  by  Numeral 

Each  body  has  a  numeral  corresponding  to  its  position  in  its  world's  body  ring  The  ’VB" 
command  will  accept  a  name  or  numeral  and  will  push  the  indicated  body  into  the  stack. 

6  4  FACE  AND  VERTEX  PERIMETER  TRAVELING 

Fetch  Next  Edge  Counter  Clockwise  about  Face  (Vertex) 

Fetch  Next  Edge  Clockwise  about  Face  (Vertex) 

Fetch  Other  Face  (Vertex)  of  the  Edge 
Fetch  Nth  Vertex  of  a  Body 
Fetch  First  Edge  of  a  Face  or  Vertex 

When  the  top  two  positions  of  the  stack  contain  an  edge  and  a  face  (or  an  edge  and  a  vertex) 
that  are  connected;  then  both  are  intensified  and  face  (vertex)  perimeter  traveling  is  possible  using 
the  or  the  ""  commands  to  obtain  the  next  edge  about  the  face  (vertex)  from  the  given  edge,  going 
in  the  clockwise  or  counter  clockwise  direction  (as  seen  from  the  exterior  surface  of  the  polyhedron). 
It  is  also  possible  while  perimeter  traveling  to  cross  to  the  other  face  (vertex)  of  the  given  edge  by 
means  of  the  command.  Remember  that  whenever  there  is  a  face,  edge  or  vertex  in  the  top  of  the 

stack,  tiie  body  to  which  it  belongs  can  be  obtained  by  using  the  ”B”  command.  Mastering  these 
commands  alleviates  the  urge  to  have  a  light  pen,  or  to  take  prolonged  trips  around  edge  rings.  The 
'W<n>‘  retrieves  the  Nth  vertex  around  the  body  ring  of  the  body  in  the  top  of  the  stack;  the  vertex 
numerals  are  displayed  when  the  "ccL”  switch  is  toggled  on.  Trivia  experts  will  be  happy  to  know  thai 
"oc.”  and  "d,"  fetch  the  next  vertex  (face),  counter  clockwise  and  clockwise  respectively,  from  the 
current  edge  with  respect  to  the  current  face  (vertex) 


EDITOR  CONTROL  COMMANDS. 


6.5  LINK  FOLLOWING  COMMANDS 

The  GEOMED  data  structure  consists  ot  twelve  word  nodes  which  contain  links  and  data.  The 
following  commcr1'4  characters  fetch  particular  links  of  the  entity  in  the  top  of  the  stack: 


WORDI: 

"<"  NFACE  Link. 

">"  PFACE  Link. 

WORD2: 

T  NED  Link. 

">”  PED  Link 

WORD3: 

■V  NVT  Link 

mah  PVT  Link 

WORD4: 

"fT  DAD  Link. 

"l r  SON  Link 

WORD5: 

"c"  BRO  Link 

•V  SIS  Link. 

W0RD6: 

•V"  ALT  Link. 

ALT2  Link. 

W0RD7: 

7  CW  Link 

M.H  CCW  Link. 

The  root  of  the  data  structure  is  the  UNIVi.RSE  node,  which  is  unique,  and  which  can  be  pushed 
into  the  stack  by  executing  the  "®"  command  Directly  accessible  from  the  UNIVERSE  node  are  the 
display  ring  and  the  world  ring: 


”ir  of  the  UNIVERSE 
"U"  of  the  UNIVERSE 
"."  of  the  UNIVERSE 
of  the  UNIVERSE 


returns  the  "now"  WORLD, 
returns  the  "first"  WORLD 
returns  the  "now"  display, 
returns  the  "first"  display 


A  display  is  not  a  node,  but  is  rather  a  ring  of  windows  The  refresh  subroutine  GEODPY, 
refreshs  the  windows  of  the  "now"  display  ring 


"t- '  and  "a"  of  a  WINDOW  travels  the  Window  Ring  of  a  display 
"  "  and  of  a  WINDOW  travels  the  Display  Ring 


Each  world  has  at  least  one  camera,  one  sun,  and  a  ring  of  bodies. 

■V"  of  a  WORLD  returns  the  "first"  SUN 

"ft"  of  a  WORLD  returns  the  "now"  CAMERA. 

"U"  of  a  WORLD  returns  the  "first"  CAMERA 

"  "  and  ","  of  a  WORLD  travels  the  World’s  Body  Ring 
"c"  and  "a"  of  a  WORLD  travels  the  World  Ring  of  the  UNIVERSE 

Each  camera  points  back  to  the  world  to  which  it  belongs  "U";  and  belongs  to  that  world’s 
camera  ring  ,  "c"  and  "a"  ;  and  has  potentially  two  rings  of  images:  the  synthetic  image  ring,  of 
images  from  the  hidden  line  eliminator,  OCCULT;  and  the  perceived  image  ring,  of  Images  from  the 
video  edge  finder,  CRE 
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6.5  LINK  FOLLOWING  COMMANDS  (continued). 

A  polyhedral  surface  is  composed  of  faces,  edges  and  vertices.  Each  particular  face,  edge,  or 
vertex  belongs  to  one  and  only  one  body;  and  in  turn  each  body  has  a  ring  of  faces,  a  ring  of  edges 
and  a  ring  of  vertices: 

"<"  and  ">"  of  a  body  travels  the  Face  Ring  of  that  body 
"<"  and  ">"  of  a  body  travels  the  Edge  Ring  of  that  body 
V  and  -a-  of  a  body  travels  the  Vertex  Ring  of  that  body. 


When  the  'VLM  switch  is  toggled  ON,  a  numeral  is  displayed  at  each  vertex  of  the  body  in  the 
top  of  the  stack.  The  N’th  vertex  of  a  body  can  be  brought  into  the  stack  by  typing  W<n>".  Besides 
belonging  to  rings;  vertices  and  faces  have  one  additional  link,  the  PED  or  first  edge  link  which  points 
to  one  of  the  edges  of  the  vertex  or  face  The  PED  of  a  vertex  or  face  in  the  top  of  the  stack  can  be 
obtained  by  typing 

Besides  belonging  to  an  edge  ring,  each  edges  points  at  its  two  faces,  its  two  vertices  and  its 
four  neighboring  edges  in  each  of  its  two  faces;  these  last  four  pointers  are  the  so  called  "wings"  of 
the  edge  and  are  used  to  travel  the  perimeters  of  faces  and  vertices  Thus  with  an  edge  in  the  top  of 
the  stack,  either  of  its  two  faces  or  two  vertices  can  be  obtained  by  typing  one  of  the  four  characters 
"Ova"  respectively. 

The  arcane  link  positions  in  words  -3,  -2  and  -1  of  a  node  can  be  retrieved  by  the  control 
"OOva"  respectively;  while  meta  mO<£va"  will  retrieve  from  words  6,  7  and  8  No  important  links 
are  stored  in  the  arcane  positions 
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SECTION  7 


DISPLAY  CONTROL  COMMANDS. 


7.1  STATUS  DISPLAY 

7.1.1 

•V." 

"i" 

7.12 

"d" 

’Vd" 

7.1.3 

ll^ll 

’VL" 

”4L" 

Status  Display  Toggle 

Toggle  Now  Window’s  Darken  Bit. 

Clear  the  page  printer 

Datum  Display  Toggle 

Datum  Format  Toggle. 

Toggle  FEV  Lights  Switch. 

Toggle  Body  Lights  Switch. 
Toggle  Frame  Lights  Switch. 


7.2  HELP  DISPLAY 

”?"  Information  Prefix 
"H"  Help 
VH"  Unhelp. 


7.3  DISPLAY  MODES 

"space”  Display  Refresh,  GEODPY 
"ALT”  GEODPY  with  hidden  lines  eliminated. 
"ocALT"  GEODPY  with  back  side  feces  eliminated. 
"/JALT"  GEODPY  everything  visible 
"(ALT"  GEODPY  with  OCCULT  diagonostics. 
Sticky  Alt 

’V_"  Sticky  ocALT 
"4."  Sticky  4ALT 
Sticky  (ALT 


7.4  EDGE  DISPLAY  BITS. 

7.4.1  ’VD"  Darken 
”(D"  Undarken. 
7  4  2  "X  NSHARP” 


7  5  FACE  COLORING. 

"X  COLOR  <n>RED  <n>GRN  <n>BLU  <n>ALB" 


7  6  CAMERA  COMMANDS 

’VC"  Push  now  camera  into  the  stack. 
"4C"  Make  new  camera 
”4}"  Step  now  camera  forwards 
”/3{"  Step  now  camera  backwards. 

‘VF"  Set  Camera’s  Focal  Plane  distance. 


7.7  WORLDS  AND  WINDOWS 

"W"  Make  Window  in  Now  Display  Ring. 

"ocW"  Make  Window  in  Now  Display  Ring. 

’’4W"  Make  New  World. 

’’{’’  and  Step  Now  Display. 

’V{’’  and  V}"  Step  Now  World 

7.8  IMAGE  RINGS. 

’VT”  Make  a  Simulated  Image  Body. 

and  Step  Perceived  CRE  Image  Ring. 

V**"  and  V-*"  Step  Predicted  OCCULT  Image  Ring. 
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7  1  STATUS  DISPLAY 

The  execution  of  nearly  every  GEOMED  command  is  followed  by  the  two  display  refresh  routine# 
called  GEODPY  and  STADPY  STADPY  refreshes  the  stack  display,  the  editor  status  display,  the  node 
contents  display,  and  the  top  of  stack  brighteners  called  "the  lights"  which  are  governed  by  the  "L" 
command.  GEODPY  scans  the  "now"  display  ring  of  the  universe  node,  and  refreshes  a  piece  of  glass 
for  each  window  having  a  camera. 


7  1  I  Status  Display  Toggle 

V*"  Toggle  Now  Window’s  Darken  Bit. 

"a”  Clear  the  page  printer 

The  STADPY  (status  display)  is  turned  on  and  off  by  the  command.  Tne  command  will 

turn  the  window  border  on  and  off,  (that  rectangle)  The  command  types  four  form  feeds,  for 
clearing  the  page  printer  of  visible  characters. 

7  1.2  "a"  Datum  Display  Togg'a 

"oca"  Datum  Format  Toggle 

The  "a"  command  causes  tK*  contents  of  the  node  at  the  top  of  the  stack  to  be  displayed  in  the 
lower  right  hand  corner  of  the  screen  Frame,  body  and  camera  nodes  have  a  special  display  which 
indicates  their  location  and  orientation;  the  special  display  format  can  be  toggled  on  and  off  by  means 
of  the  "oca"  command  In  the  regular  format  node  display,  the  appropriate  link  following  commands  for 
the  different  words  of  the  node  are  indicated 

7.1.3  "L"  Toggle  FEV  Lights  Switch 

"ocL"  Toggle  Body  Lights  Switch. 

”/3L"  Toggle  Frame  Lights  Switch 

When  Ihe  "L"  switch  is  on;  faces,  edges  and  vertices  in  the  top  of  the  stack  are  intensified. 
When  the  "ocL"  switch  is  on,  numerals  are  displayed  for  all  the  vertices  of  the  body  in  the  top  of  the 
stack.  The  vertex  numerals  can  be  used  for  obtaining  a  particular  vertex  using  the  "<V"  command 
When  the  "/JL"  switch  is  on,  three  vectors  are  displayed  indicating  the  direction  of  the  axes  of  the 
current  frame  of  reference;  the  vectors  are  labeled  respectively  by  a  letter  "X",  "Y",  or  "Z"  followed 
by  a  number  between  -1.0  and  +1.0  indicating  whether  the  vector  is  going  away  or  coming  towards  the 
current  camera. 
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7.2  HELP  DISPLAY. 

Information  Prefix. 

"H"  Help 
’VHM  Unhelp. 

Typing  a  question  mark  "?"  followed  by  any  character  will  type  a  one  line  reminder  of  what 
commands  are  invoked  by  that  character  The  "H"  command  allows  the  user  to  read  this  document  a 
page  at  a  time  while  using  GEOMED.  Help  starts  by  displaying  page-4  and  waits  for  other  desired 
page  numbers;  typing  a  carraige  return  will  exit  the  help  with  the  display  persisting,  control  carraige 
return  will  exit  the  help  with  the  display  cleared  The  VH"  command  clears  the  HELP  display  glass. 

7.3  DISPLAY  MODES 

"space"  Display  Refresh,  GEODPY 

"ALT"  GEODPY  with  hidden  lines  eliminated 

'VALT"  GEODPY  with  back  side  faces  eliminated. 

"/tf  ALT"  GEODPY  everything  visible 

"<ALT"  GEODPY  with  OCCULT  diagonostics. 

V  Sticky  Alt 
VJ'  Sticky  ocALT. 

"4."  Sticky  /SALT 
X"  Sticky  <ALT 

There  are  two  basic  display  modes:  with  and  without  the  hidden  lines  eliminated.  Initially  the 
display  refresh  displays  all  the  lines  that  are  visible  from  the  simulated  cameras  of  the  windows  of  the 
now  display  ring  The  "ALT"  commands  do  one  refresh  in  the  mode  selected  by  the  control  bits  An 
easy  hidden  line  elimination  takes  less  than  i  second;  the  hardest  take  up  to  thirty  seconds.  The 
underbar  commands,  make  the  selected  display  refresh  mode  sticky,  all  refreshes  are  done  in  that 
mode  until  the  next  underbar  The  spacebar  command  redoes  the  last  refresh. 


7  4  EDGE  DISPLAY  BITS 
7  4  1  VD"  Darken.  "<D"  Undarken 

Given  a  body  or  an  edge  in  the  top  of  the  stack;  these  two  commands  set  or  reset  the  darken 
bit  all  the  specified  edges.  Darkened  edges  will  not  be  intensified  by  the  display  refresh. 

7  4.2  "X  NSHARP" 

"X  GOURAUD" 

Given  a  body  c<  an  edge  in  the  top  of  the  stack,  those  two  extended  scanner  commands  6et  the 
"not  sharp"  and  the  "Gouraud"  bits,  respectively  all  the  edges  of  the  body  or  of  the  given  edge.  The 
two  bits  specify  different  kinds  of  intensity  smoothing  to  the  "40"  command.  The  "not  sharp"  bit 
causes  not  sharp  and  not  folded  edges  to  be  not  visible  after  a  hidden  line  elimination,  which  yields  line 
drawings  with  a  rounded  appearance. 
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7.5  FACE  COLORING. 

"X  COLOR  <n>RED  <n>GRN  <n>BLU  <n>ALBM 

The  coloring  command  app'  to  a  body  or  a  face  sets  the  bytes  of  words  4  and  5  of  all  the 
faces  given  The  <n>  arguments  represent  percentage  values  between  0  and  100;  the  argument  must 
be  suffixed  by  a  letter:  R,  G,  6  or  A  standing  for  red,  gr*en,  blue  and  albedo.  Combining  the  colors 
red  and  green  gives  yellow;  red  and  blue  gives  lavender;  blue  and  green  give  a  light  sky  blue. 
Lowering  the  albedo  turns  red  into  crimson,  yellow  into  brown,  green  into  dark  green,  sky-blue  into 
slate,  blue  into  deep  blue,  and  lavender  into  purple. 

In  order  to  get  the  so  called  "I  and  C"  required  by  DDVID’s  color  command,  ”CM;  suffix  the 
filename  you  type  to  MKVID  with  a  "/O'*  switch  To  display  a  color  television  picture  on  the  color 
synthesizer;  you  must  remove  a  BNC  terminator  from  the  color  synthesizer,  which  is  located  in  the 
kludge  bay  above  the  video  switch  cable  fan  out;  you  must  place  the  toggle  on  the  upper  left  of  the 
color  television  set  in  the  up  position;  and  you  must  give  the  following  commands  to  DDVID: 
MC<filename>  <ret*  rn>  E<return>  R<return>M 

The  color  synthesizer  requires  twelve  data  disc  channels,  which  are  usually  not  available  in  the 
day.  The  intensity  channels  are  36,  35,  34,  33,  37  and  32;  the  color  channels  are  31,  24,  23,  27,  30 
and  25  The  system  information  programs  DDUSE  and  FINGER  will  type  information  on  who  is  using 
which  channels  and  where  particular  users  are  located. 


7  6  CAMERA  COMMANDS 

’VC"  Push  now  camera  into  the  stack. 

VF"  Set  Camera’s  Foca!  Plane  distance. 

”/3C"  Make  new  camera 

”/&}*  Step  now  camera  forwards 

"/*{"  Step  now  camera  backwards 

There  are  two  basic  camera  commands:  ’VC”  and  VF".  The  ’VC"  command  will  push  the  now 
camera  node  into  the  stack.  The  ,VF<distance>M  command  will  set  the  now  camera’s  focr'  nlane 
distanri  to  the  given  value,  the  distance  is  assumed  to  be  in  units  of  millimeters.  The  initial  focal  plane 
di*.  a  is  12  5  mm  The  additional  camera  commands  allow  the  creation  and  use  of  a  ring  of  cameras. 
The  /3C"  command  will  create  a  new  camera  at  the  end  of  the  camera  ring  of  the  now  world.  The 
M/J}”  and  M/3{”  commands  will  advance  or  retreat  the  now  camera  around  the  camera  ring. 


DISPLAY  CONTROL  COMMANDS. 


7.7  WORLDS  AND  WINDOWS 

"W"  Mak®  Window  in  Now  Display  Ring. 

VW"  Make  Window  in  N®w  Display  Ring 

M4WM  Mak®  New  World 

"{"  and  St®p  Now  Display 

Vf  and  V}"  St®p  Now  World 

Although,  the  data  structure  below  GEOMED  allows  many  worlds  and  windows;  these  commands 
are  not  intended  for  general  use.  The  "W"  command  will  make  a  new  display  window,  such  as  the  one 
made  by  the  crosseyed  stereo  pairs*  macro,  "flco".  Windows  can  be  scaled  and  moved  about  the 
screen  using  the  Euclidean  transformations,  one  translation  unit  corresponds  to  100  display  units.  The 
VW"  command  will  make  a  new  window  in  a  new  display  refresh  ring;  and  the  "<*{”,  V}M  and 
will  as  stated  advance  the  display  or  world  rings  When  there  is  more  than  one  camera  (or  one 
world)  the  node  identification  of  the  now  camera  (or  now  world)  it  displayed  in  the  status. 

7.8  IMAGE  RINGS. 

VT”  Make  a  Simulated  Image  Body 

M©c*-"  and  "<*“♦”  Step  Predicted  OCCULT  Image  Ring 

"/t+m  and  Step  Perceived  CRE  Image  Ring 

The  results  of  a  hidden  line  elimination  can  be  used  to  create  a  special  kind  of  polyhedron  that 
approximates  the  image  An  image  polyhedron  is  like  a  photographic  print  with  faces,  edges  and 
vertices  representing  the  details  of  the  image  that  is  on  the  print  The  'VT  command  (take  a  picture) 
creates  such  an  image  polyhedral  body  and  attachs  it  to  the  OCCULT  image  ring  of  the  noew  camera. 
Similar  to  VT",  the  "41"  command  inputs  an  image  polyhedral  bodies  from  a  CRE  file  and  attachs  them 
to  the  CRE  image  ring  of  th®  now  camera  The  VT"  command  images  are  synthetic  and  the  "fi\" 
command  images  are  perceived;  the  display  refresh  includes  the  first  CRE  and  the  firsl  OCCULT  image 
of  the  now  camera  ring  (as  weii  as  its  usual  view  of  its  simulated  world).  The  control  and  meta,  left 
and  right  arrow,  commands  will  step  the  CRE  and  OCCULT  rings  at  stated  above  The  creation  of 
structures  for  both  synthetic  and  perceived  images  brings  us  to  th^  start  of  computer  vision  and  the 
conclusion  of  GEOMED 
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TEXT  COMMANDS  OF  GEOMED  1973. 

Toward  the  end  of  !  973,  text  nodes  and  text  commands  were  added  to  GEOMED  to  demonstrate 
its  potential  value  for  mechanical  drawing.  This  work  was  done  by  Tovar  Mock,  and  the  resulting 
alternate  version  of  GEOMED  is  available  on  the  system  as  the  program  named  "G" 

Text  nodes  are  created  (or  edited)  by  applying  the  "T”  command  with  a  vertex  in  the  top  of 
stack  The  header  of  a  text  node  list  is  called  a  Y-node  and  can  be  reached  from  a  text  node  by  the 
"<"  command;  Y-nodes  carry  their  own  3*0  space  locus  and  so  can  be  moved  about  using  the  Euclidean 
transformation.  The  resulting  data  structures  can  only  be  saved  and  restored  by  means  of  the  "<0"  and 
"<1"  commands,  which  dump  and  restore  D3D  files.  The  D3D  format  I/O  doesn't  exist  in  present 
GEOMED.  Tha  "T"  command  accepts  text  by  means  of  an  editor  resembling  the  system's  editors  TV  and 
E,  which  use  the  system  line  edit  commands.  The  particular  line  edit  mode  commands  of  G  are: 

<CR>  Forward  1  line 
<VT>  Backward  1  line 

ocO  Forwaro  4  lines 
oi<<  Backward  4  lines 
oC<>  Forward  16  lines 
oC<<  Backward  16  lines 

<D  Delete  a  line 

(I  Enter  line  insert  mode 

ocZ  Concatenate  next  line  with  current  line 

oc(E  Return  to  GEOMED 
oc<V  Update  display 
o c</  Shrink  charac’er  size 
o <(\  Expand  character  size 

The  best  way  to  get  a  labeled  drawing  into  hardcopy  is  to  ”P“  plot  it  out  of  G  into  a  plot  file, 
”  PLT";  and  then  to  use  PLTVEC  to  output  the  drawing  on  the  Calcomp  Plotter  or  to  use  XAP  to  output 
the  drawing  to  the  XGP,  Xerox  Graphics  Printer  See  section  5  2,  for  details  on  how  to  make  hardcopy 
drawings. 
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COMMAND  INDEX  BY  ASCII  ORDER. 


PAGE 

ASCII 

CHARACTER 

COMMAND 

- 

OOO 

NULL 

No  operation. 

31 

001 

l 

Push  stack  down 

31 

od 

Rotate  stack  down. 

2 

002 

o £ 

Control  key  prefix. 

2 

003 

fi 

Meta  key  prefix 

33 

004 

A 

PVT,  Positive  vertex  link 

26 

005 

Evert  Body. 

26 

oC- 

Body  Subtraction 

2 

006 

< 

Meta-Control  keys  prefix. 

1 

007 

n 

Set  rotation  strength,  REEL. 

18 

010 

X 

Set  translation  strength,  TDEL 

* 

01 1 

TAB 

No  operation 

- 

012 

LF 

No  operation, 

- 

013 

VT 

No  operation 

- 

014 

FF 

No  operation 

19 

015 

CR 

Reset  iteration  count 

1 

016 

00 

Instant  cube. 

8 

oceo 

Instant  torus 

13 

ftoo 

Crosseyed  stereo. 

36 

017 

a 

Datum  display  Toggle 

36 

ocd 

Datum  display  format  Toggle, 

33 

020 

c 

BRO,  parts  tree  link. 

33 

021 

3 

SIS,  parts  tree  link 

33 

022 

n 

DAD,  parts  tree  link 

26 

*n 

Body  Intersection 

33 

023 

u 

SON,  parts  tree  link 

26 

ocU 

Body  Union. 

19 

024 

V 

Enable  ali  body  motions. 

19 

0<V 

Disable  frame  motion. 

19 

/JV 

Disable  vertex  motion. 

19 

<v 

Disable  parts  motion. 

29 

025 

3 

Comment  prefix. 

29 

3 

Print  comment. 

29 

43 

Wait  for  character 

29 

<3 

Print  comment  and  wait. 

31 

026 

® 

Push  universe  node  into  stack 

31 

027 

H 

Sv/ap  stack  elements  1  and  2. 

31 

o£H 

Swap  stack  elements  1  and  3 

31 

fi* 

Swap  stack  elements  1  and  last. 

31 

Swap  stack  elements  2  and  3. 

37 

03f 

Sticky  ALT  display  refresh. 

37 

o£_ 

Sticky  ocALT  display  refresh. 

37 

fi - 

Sticky  4ALT  display  refresh. 

37 

Sticky  (ALT  display  refresh. 

33 

0'  i 

-> 

ALT2,  link  fetch. 

- 

0'  2 

TILDE 

No  operation. 

- 

t  33 

/ 

No  operation 

33 

034 

< 

NED,  link  fetch 

33 

035 

> 

PED,  link  fetch. 

36 

036 

5 

Toggle  status  display  enable. 

36 

o£» 

Toggle  window  display  enable 

33 

037 

V 

NVT,  link  fetch. 

37 

040 

SPACE 

Display  refresh. 

19 

041 

1 

Set  translation  default. 

- 

042 

n 

No  operation. 

36 

043 

• 

Clear  page  printer. 

31 

Enter  DDT. 
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PAGE 

ASCII 

CHARACTER 

COMMAND 

26 

044 

1 

Make  convex. 

26 

Edge  slurp 

18 

045 

7. 

Sot  DDEL,  dilation  strength. 

- 

046 

& 

No  operation. 

- 

047 

l 

No  operation. 

17 

050 

( 

Euclidean  transformation  minus  V 

17 

051 

) 

Euclidean  transformation  plus  Y 

17 

052 

* 

Euclidean  transformation  plus  Z. 

32 

053 

♦ 

Fetch  other  face  or  vertex 

32 

054 

1 

Fetch  clockwise 

17 

055 

Euclidean  transformation  minus  Z, 

32 

056 

Fetch  counter  clockwise 

17 

057 

/ 

Halve  strength  of  transformation, 

19 

060-071 

DIGITS  0  THRU  9 

17 

072 

: 

Euclidean  transformation  plus  X 

17 

073 

Euclidean  transformation  minus  X 

3? 

07  4 

< 

NFACE,  link  fetch. 

- 

075 

r 

No  operation 

33 

076 

> 

PFACE,  link  fetch 

2 

077 

? 

Information  prefix. 

17 

100 

& 

Set  rotation  default. 

27 

101 

A 

Attach. 

19 

/*A 

Cycle  Axis  count. 

32 

102 

B 

Body  of  a  face,  edge  or  vertex. 

32 

ocB 

Retrieve  body  by  numer  al  or  by  name 

23 

103 

C 

Copy 

13 

Push  now  camera  into  the  stack 

27 

104 

D 

Detach. 

37 

Darken 

37 

<D 

Undarken. 

25 

105 

E 

Make  edge  and  vertex 

31 

it 

Exit  GEOMED 

18 

106 

F 

Step  trame  selector  torwards 

38 

0 <F 

Accept  focal  plane  distance 

18 

($ 

Step  frame  selector  backwards. 

25 

107 

G 

Glue  face-face. 

37 

1  10 

H 

Help  display 

28 

111 

1 

Input  B3D 

28 

od 

Input  CAM 

28 

Input  CRE 

28 

<1 

Input  GEM 

25 

112 

J 

Join  vertex-vertex 

23 

113 

K 

Kill  entity 

23 

ocK 

Kill  edge  and  vertex. 

36 

114 

L 

Face,  edge,  vertex  lights  toggle 

36 

Body  lights  toggle 

36 

fil 

Frame  of  reference  lights  toggle. 

25 

115 

M 

Midpoint  and  edge 

32 

\i  6 

N 

Name  a  body 

28 

117 

0 

Output  B3D. 

28 

*0 

Output  CAM 

28 

flo 

Output  V2D 

28 

i 0 

Output  GEM 

29 

120 

p 

Plot  file  output. 

19 

121 

0 

Toggle  frame  origin  switch. 

24 

122 

R 

Rotation  completion. 
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PAGE 

ASCII 

CHARACTER  COMMAND 

24 

123 

S 

Sweep  cylinder. 

24 

ocS 

Sweep  pyramid 

24 

/is 

Sweep  cylinder  edges  not  sharp. 

24 

<$ 

Sweep  pyramid  edges  not  sharp 

39 

124 

ocT 

Take  a  simulated  picture 

20 

125 

U 

Unmove  a  body 

25 

126 

V 

Make  vertex  body 

32 

<*V 

Retrieve  Nth  vertex  of  a  body 

25 

/*v 

Make  body  n  >de 

39 

127 

W 

Make  window  in  now  display  ring 

39 

<*W 

Make  window  in  a  new  display  ring 

39 

/JW 

Make  new  world  at  end  of  world  ring 

- 

130 

X 

Extended  command  scanner: 

21 

PLACE  <x>  <y>  (z) 

21 

ORIENT  <pan>  <tilt>  <swing> 

22 

CUBIC  <X  width)  <Y  height  <2  depth) 

22 

BALL  (radius)  <M  longitucas)  (N  latitudes) 

22 

CYLN  (radius)  (N  sides)  <Z  length) 

27 

CUT  (x)  (y)  (z> 

38 

COLOR  (n)RED  (n)BLU  (n)GRN  (n)ALBEDO 

37 

NSHARP 

24 

PRISMOID 

24 

SILHOUETTE  (zmin)  (zmax) 

- 

131 

Y 

No  operation 

29 

132 

4Z 

Read  commands  from  GEO  text  file. 

- 

133 

[ 

No  operation. 

17 

134 

\ 

Double  strength  of  transformation. 

- 

135 

] 

No  operation. 

31 

136 

T 

Pop  stack 

31 

ocT 

Rotate  stack  upwards 

33 

137 

4- 

ALT  link  fetch 

39 

<*«- 

Step  thru  simulated  image  ring  of  now  earner 

- 

140 

f 

No  operation. 

- 

141  THRU  172 

Lower  case  letters  same  as  upper  case. 

39 

173 

{ 

Step  now  display  backwcrds 

39 

«{ 

Step  now  world  backwards. 

39 

fi\ 

Step  now  camera  backwards 

26 

174 

1 

Invert  edge  linear  orientation. 

37 

175 

ALT 

Display  refresh  with  hidden  lines  eliminated. 

37 

ocALT 

Display  refresh  with  backside  faces  eliminate 

37 

4ALT 

Display  refresh  with  everything  visible 

37 

<ALT 

Display  refresh  with  OCCULT  diagonostics. 

39 

176 

} 

Step  now  display  forwards. 

39 

oc[ 

Step  now  world  forwards. 

39 

fi) 

Step  now  camera  forwards. 

- 

177 

RUBOUT  No  operation. 
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